hubermedia documentation 2015 html
eT4® META - Hypersearch
Entry Point
http://meta.et4.de/rest.ashx/hypersearch/
Responsetype
TemplateBased-XML-Response TemplateBased-JSON-Response TemplateBased-Protobuff-Response
Description
The eT4®META Hyper search is a meta-search based on meta-data.


The eT4 only provides data from its own data pool.

The eT4.META API provides data from ET4, as well as from vendors that provide ecMaps-4.0-compliant GeoRSS Feed feeds.
This API is the basic building block of ecMaps.
Thus, this is a meta-search.

The eT4.Hyper API takes the data from eT4.Meta.API and enriches it with other data.


Functionality:

  1. Search for landlords via eT4.Meta.API
  2. Search bookable rooms / apartments / packages to the landlords with out hyper-providers Booking.com, Et4Freimeldung, Feratel, NetHotels, butterfly, Seekda, Tiscover, Tomas, Wild East
  3. Data are blended and exported as a feed, or output rendered from the eT4.Meta templates.
    Supported templates are: ET2014AET2014A_HYPER and eSuchWas (feed),

Requirements for this functionality is that the respective provider ID is provided in the data in eT4-META.
The internal provider id has to be saved in the correspanding elements (SYSTEMID_TOMAS, SYSTEMID_SCHMETTERLING [...]).

Parameters

Obligatory in eT4.META-HyperSearch:

Parameter Type Description
template (-> eT4.META-search:template) String The template determines the output format of the data and the desired version of the eT4®META schemas.  (Supported templates: eSuchWas, ET2014A, ET2014A_MULTI, ET2014A_HYPER)
experience (-> eT4.META-search:experience) String The experience specifies the name of the project data pool to be used.  (obligatory)
type (-> eT4.META-search:type String Used to specify the main content type/topic to search. Hotel, Event, Gastro, Tour, POI, City, Area, Package, Article or Web.
occupation String Occupations
startdate Date startdate
enddate Date enddate

 

These are optional parameters in eT4.META-HyperSearch:

Parameter Type Description
hypersort String Sort of the results: BookableFirst, Price, PriceDesc, Name, NameDesc, Relevance, HighlightPrice, Distance, HighLightStarsPrice, HighlightStarsDescPrice, Meta, SpecialLastChange, Plz, City (Default: Price)
pricefrom Decimal price from
priceto Decimal price to
removeemptyitems Boolean If true, all items without hyperobjcts will be removed from response. (Default: true)
activatecaching Boolean if false, no caching will be used. (Default: true)

       

All parameters of eT4.META-Search can be used in eT4.META-HyperSearch, too (especially qrequesttemplatelimitoffset).
See its complete documentation for more Information.

Integration
Templatesamples
Samples
Sample 1

Get hyperinformation from experience demo-dahoam to one object (hashlink 419FE08232977EA5429DA7D5E836E566) for 2 adults with 1 child (age 2) from 01.05.2015 to 08.05.2015 as JSON


http://meta.et4.de/rest.ashx/hypersearch/ET2014A.json/?experience=demo-dahoam&type=Hotel&q=hashlink:419FE08232977EA5429DA7D5E836E566&startDate=01.05.2015&endDate=08.05.2015&occupation=2:2

response
Copy Code
{
    "status": "OK",
    "count": 1,
    "overallcount": 1,
    "channels": [],
    "facetGroups": [],
    "items": [{
        [...]    
        "hyperObjects": [{
            "source": "ET4Freimeldung",
            "isBookable": false,
            "attributes": [{
                "key": "Currency",
                "value": "EUR"
            }],
            "numbers": [{
                "type": "Price",
                "value": 0.0
            },
            {
                "type": "PriceBase",
                "value": 12.0
            }],
            "hyperSubObjects": [{
                "title": "2 Doppelzimmer mit Dusche",
                "type": "Doppelzimmer",
                "changed": "2014-08-26T10:37:47.387+00:00",
                "texts": [{
                    "type": "CancelationBookingConditions"
                },
                {
                    "type": "Description",
                    "value": ""
                },
                {
                    "type": "ExtraBookingConditions"
                }],
                "attributes": [{
                    "key": "SourceId",
                    "value": "40"
                },
                {
                    "key": "BaseSourceId",
                    "value": "11421"
                },
                {
                    "key": "Currency",
                    "value": "EUR"
                }],
                "media_objects": [],
                "keywords": ["None"],
                "numbers": [{
                    "type": "OccupancyDefault",
                    "value": 0.0
                },
                {
                    "type": "OccupancyMaximum",
                    "value": 0.0
                },
                {
                    "type": "OccupancyMinimum",
                    "value": 0.0
                },
                {
                    "type": "Price",
                    "value": 0.0
                },
                {
                    "type": "PriceBase",
                    "value": 12.0
                }]
            }]
        },
       
    }]
}

You can find a full sample of json response here.

Sample 2

Get hyperinformation from experience demo-dahoam for 2 adults with 1 child (age 4) from 01.05.2015 to 08.05.2015 for page 2 with 10 items  


http://meta.et4.de/rest.ashx/hypersearch/ET2014A.xml/?experience=demo-dahoam&type=Hotel&startDate=01.05.2015&endDate=08.05.2015&Occupation=2:4&limit=10&offset=10

response
Copy Code
<result xmlns="http://meta.et4.de/ET2014A">
    <status>OK</status>
    <count>10</count>
    <overallcount>117</overallcount>
    <items>
        <item>
            [...]
            <hyperObjects>
                <hyperObject>
                    <source>Tomas</source>
                    <url>
                        http://booking.et4.de/de/demo_dahoam/01.05.2015-08.05.2015/2:4/GER00020060155975422/GER00020060155975545
                    </url>
                    <isBookable>true</isBookable>
                    <attributes>
                        <attribute key="Currency">EUR</attribute>
                    </attributes>
                    <numbers>
                        <number type="Price">514.5</number>
                        <number type="PriceBase">73.5</number>
                    </numbers>
                    <hyperSubObjects>
                        <hyperSubObject>
                            <title>Doppelbettzimmer mit Balkon mit Kinderzimmer</title>
                            <type/>
                            <changed>0001-01-01T00:00:00Z</changed>
                            <texts>
                                <text type="CancelationBookingConditions"/>
                                <text type="Description"/>
                                <text type="ExtraBookingConditions"/>
                            </texts>
                            <attributes>
                                <attribute key="SourceId">GER00020060155975545</attribute>
                                <attribute key="BaseSourceId">GER00020060155975422</attribute>
                                <attribute key="Currency">EUR</attribute>
                            </attributes>
                            <keywords>
                                <keyword>Breakfast</keyword>
                            </keywords>
                            <numbers>
                                <number type="OccupancyDefault">3</number>
                                <number type="OccupancyMaximum">0</number>
                                <number type="OccupancyMinimum">0</number>
                                <number type="Price">514.5</number>
                                <number type="PriceBase">73.5</number>
                            </numbers>
                        </hyperSubObject>
                    </hyperSubObjects>
                </hyperObject>
                [...]
            </hyperObjects>
        </item>
    </items>
</result>

Get full xml response sample here

Sample 3

Get hyperinformation from experience demo-dahoam for hotels only with 3+ stars for 2 adults with 1 child (age 1) from 01.05.2015 to 08.05.2015 for page 2 with 10 items  


http://meta.et4.de/rest.ashx/hypersearch/ET2014A.xml/?experience=demo-dahoam&type=Hotel&startDate=01.05.2015&endDate=08.05.2015&Occupation=2:1&q=rating_DEHOGA:[50 TO 100] AND category:Hotel&limit=5&offset=0

response
Copy Code

Sample 4

Get hyperinformation from experience demo-dahoam for objects in city lam with wlan for 2 adults with 1 child (age 5) from 01.05.2015 to 08.05.2015 for page 1 with 5 items  

http://meta.et4.de/rest.ashx/hypersearch/ET2014A.xml/?experience=demo-dahoam&type=Hotel&startDate=01.05.2015&endDate=08.05.2015&Occupation=2:2&q=city:lam AND tag:WLAN&limit=5&offset=0

response
Copy Code

Check out more samples at our API-Explorer: http://developer.et4.de/explorer/?samples=true

See Also

Search

params

 

 


© hubermedia 2018 Privacy Statement Imprint